Configuring the XForms Service Container

This topic describes the procedure to configure the XForms service container.

You can manage the response time of the XForms service container by specifying the cache size and the time interval for content expiry. Cache refers to the location where frequently-accessed content is stored.

You can specify the time period for which requested content is retrieved from the browser cache rather than from the server. On requesting an XForm for the first time, the.caf file is converted to HTML, which is stored in the server cache and rendered in the browser. On receiving subsequent requests for the same XForm, the HTML file is rendered directly from the server cache. This eliminates the need to convert.caf files to HTML files unless you modify an XForm and publish it to runtime.

1. In the My Applications App Palette, select (System Resource Manager). 
2. Right-click XForms and select Properties. The Properties - XForms window appears. It displays the General, JRE Configuration, Log Settings, XForms, and Foundation Framework tabs.
3. Click the XForms tab to specify settings for content expiry and cache size.
4. Select an option in the Content Expiry area to specify the time period for which the cache must be maintained on your computer.
   
   • Select Immediately to retrieve the HTML for the .caf file. All requests are sent to the backend, and the HTML is returned with the 200 status code. Selecting this option disables the Cache size field, indicating that no cache will be maintained.
   • Select Everytime to simultaneously delete the cache so that all requests go to the backend. The XForms cache returns the 304 status code if its last modified date is greater than the last modified date of the.caf in XMLStore, otherwise it returns the HTML for the.caf with the 200 status code.
   • Select After and type a numerical value in the days field to specify the number of days after which the cache is to be deleted. The XForms Gateway sets cache expiry from the date specified, and requests to backend are sent only after the specified date.
   • Select On and select an option from the calendar control to specify the date on which the cache is to be deleted.
     When you request for an XForm or refresh it at runtime, the XForms Gateway sets the modification date of the XForm that is available in the cache as its last modified date. This date is used to identify and retrieve the latest version of the XForm from the backend.
     Depending on the selected content expiry option, the cache on your computer is periodically deleted and refreshed from the backend when you send a request. By selecting the appropriate option, you can ensure access to the latest information from the backend.
     Note: Cache expiry also depends on the option set for Check for newer versions of stored pages in the Internet Options dialog box of the Internet Explorer. For details, refer to How Internet Explorer cache settings affect Web browsing.
5. Enter a numerical value in the Cache size field to specify the maximum number of XForms to be cached.
   The cache size must be set depending on various conditions such as the computer hardware and the application's deployment size, extent of usage, and desired performance level. As these factors differ, the optimal cache size is specific to each installation.
   For example, a small cache value may render the cache ineffective in cases where a large number of XForms are accessed and used. On the other hand, a large cache value will consume limited system resources and may affect performance. In this case, to define an optimal cache size, you must take into account factors such as the resources available and the scale of Web service operations.
6. To select a free port number to enable cache coherence manually, select Manual and provide an unused free port number in the Port Number field below. By default, the Manual field is Not selected and the framework automatically assigns an unused free port number.
   Note: You must restart the service container to apply the change.
7. Enter the interceptor implementation class names in the Class Name field. These entries must be separated by the OS-specific classpath delimiters.
8. Click .
   The configuration specified for the XForms service container is saved.
   Note: For information about the settings required on the General and Log Settings tabs, refer to SOAP Processor Configuration Interface and Logging Configuration Interface, respectively.

   After you complete this task:
   You must restart the XForms service container to affect the modified service container configuration.